
<!DOCTYPE HTML>
<html lang="" >
    <head>
        <meta charset="UTF-8">
        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
        <title>文档格式规范 · GitBook</title>
        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
        <meta name="description" content="">
        <meta name="generator" content="GitBook 3.2.3">
        
        
        
    
    
    <link rel="stylesheet" href="../../gitbook/style.css">

    
            
                
                <link rel="stylesheet" href="../../gitbook/gitbook-plugin-chapter-fold/chapter-fold.css">
                
            
                
                <link rel="stylesheet" href="../../gitbook/gitbook-plugin-katex/katex.min.css">
                
            
                
                <link rel="stylesheet" href="../../gitbook/gitbook-plugin-alerts/style.css">
                
            
                
                <link rel="stylesheet" href="../../gitbook/gitbook-plugin-emphasize/plugin.css">
                
            
                
                <link rel="stylesheet" href="../../gitbook/gitbook-plugin-mermaid-gb3/mermaid/mermaid.css">
                
            
                
                <link rel="stylesheet" href="../../gitbook/gitbook-plugin-codeblock-label/block.css">
                
            
                
                <link rel="stylesheet" href="../../gitbook/gitbook-plugin-code/plugin.css">
                
            
                
                <link rel="stylesheet" href="../../gitbook/gitbook-plugin-search-pro/search.css">
                
            
                
                <link rel="stylesheet" href="../../gitbook/gitbook-plugin-click-reveal/click_reveal.css">
                
            
                
                <link rel="stylesheet" href="../../gitbook/gitbook-plugin-expandable-chapters-interactive/expandable-chapters.css">
                
            
                
                <link rel="stylesheet" href="../../gitbook/gitbook-plugin-highlight/website.css">
                
            
                
                <link rel="stylesheet" href="../../gitbook/gitbook-plugin-search/search.css">
                
            
                
                <link rel="stylesheet" href="../../gitbook/gitbook-plugin-fontsettings/website.css">
                
            
        

    

    
        
    
        
    
        
    
        
    
        
    
        
    


    

        
    
    
    <meta name="HandheldFriendly" content="true"/>
    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
    <meta name="apple-mobile-web-app-capable" content="yes">
    <meta name="apple-mobile-web-app-status-bar-style" content="black">
    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="../../gitbook/images/apple-touch-icon-precomposed-152.png">
    <link rel="shortcut icon" href="../../gitbook/images/favicon.ico" type="image/x-icon">

    
    <link rel="next" href="code.html" />
    
    
    <link rel="prev" href="partition.html" />
    

    </head>
    <body>
        
<div class="book">
    <div class="book-summary">
        
            
<div id="book-search-input" role="search">
    <input type="text" placeholder="Type to search" />
</div>

            
                <nav role="navigation">
                


<ul class="summary">
    
    

    

    
        
        
    
        <li class="chapter " data-level="1.1" data-path="../../">
            
                <a href="../../">
            
                    
                    实验简介
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.2" data-path="../../notes/log.html">
            
                <a href="../../notes/log.html">
            
                    
                    更新日志
            
                </a>
            

            
        </li>
    

    
        
        <li class="header">实验之前</li>
        
        
    
        <li class="chapter " data-level="2.1" data-path="../pre-lab/env.html">
            
                <a href="../pre-lab/env.html">
            
                    
                    环境部署
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="2.2" data-path="../pre-lab/gdb.html">
            
                <a href="../pre-lab/gdb.html">
            
                    
                    GDB 调试方法*
            
                </a>
            

            
        </li>
    

    
        
        <li class="header">实验指导</li>
        
        
    
        <li class="chapter " data-level="3.1" >
            
                <span>
            
                    
                    实验指导零
            
                </span>
            

            
            <ul class="articles">
                
    
        <li class="chapter " data-level="3.1.1" data-path="../lab-0/guide/intro.html">
            
                <a href="../lab-0/guide/intro.html">
            
                    
                    摘要
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.1.2" data-path="../lab-0/guide/part-1.html">
            
                <a href="../lab-0/guide/part-1.html">
            
                    
                    创建项目
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.1.3" data-path="../lab-0/guide/part-2.html">
            
                <a href="../lab-0/guide/part-2.html">
            
                    
                    移除标准库依赖
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.1.4" data-path="../lab-0/guide/part-3.html">
            
                <a href="../lab-0/guide/part-3.html">
            
                    
                    移除运行时环境依赖
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.1.5" data-path="../lab-0/guide/part-4.html">
            
                <a href="../lab-0/guide/part-4.html">
            
                    
                    编译为裸机目标
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.1.6" data-path="../lab-0/guide/part-5.html">
            
                <a href="../lab-0/guide/part-5.html">
            
                    
                    生成内核镜像
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.1.7" data-path="../lab-0/guide/part-6.html">
            
                <a href="../lab-0/guide/part-6.html">
            
                    
                    调整内存布局
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.1.8" data-path="../lab-0/guide/part-7.html">
            
                <a href="../lab-0/guide/part-7.html">
            
                    
                    重写程序入口点
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.1.9" data-path="../lab-0/guide/part-8.html">
            
                <a href="../lab-0/guide/part-8.html">
            
                    
                    使用 QEMU 运行
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.1.10" data-path="../lab-0/guide/part-9.html">
            
                <a href="../lab-0/guide/part-9.html">
            
                    
                    接口封装和代码整理
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.1.11" data-path="../lab-0/guide/summary.html">
            
                <a href="../lab-0/guide/summary.html">
            
                    
                    小结
            
                </a>
            

            
        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter " data-level="3.2" >
            
                <span>
            
                    
                    实验指导一
            
                </span>
            

            
            <ul class="articles">
                
    
        <li class="chapter " data-level="3.2.1" data-path="../lab-1/guide/intro.html">
            
                <a href="../lab-1/guide/intro.html">
            
                    
                    摘要
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.2.2" data-path="../lab-1/guide/part-1.html">
            
                <a href="../lab-1/guide/part-1.html">
            
                    
                    什么是中断
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.2.3" data-path="../lab-1/guide/part-2.html">
            
                <a href="../lab-1/guide/part-2.html">
            
                    
                    RISC-V 中的中断
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.2.4" data-path="../lab-1/guide/part-3.html">
            
                <a href="../lab-1/guide/part-3.html">
            
                    
                    程序运行状态
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.2.5" data-path="../lab-1/guide/part-4.html">
            
                <a href="../lab-1/guide/part-4.html">
            
                    
                    状态的保存与恢复
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.2.6" data-path="../lab-1/guide/part-5.html">
            
                <a href="../lab-1/guide/part-5.html">
            
                    
                    进入中断处理流程
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.2.7" data-path="../lab-1/guide/part-6.html">
            
                <a href="../lab-1/guide/part-6.html">
            
                    
                    时钟中断
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.2.8" data-path="../lab-1/guide/summary.html">
            
                <a href="../lab-1/guide/summary.html">
            
                    
                    小结
            
                </a>
            

            
        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter " data-level="3.3" >
            
                <span>
            
                    
                    实验指导二
            
                </span>
            

            
            <ul class="articles">
                
    
        <li class="chapter " data-level="3.3.1" data-path="../lab-2/guide/intro.html">
            
                <a href="../lab-2/guide/intro.html">
            
                    
                    摘要
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.3.2" data-path="../lab-2/guide/part-1.html">
            
                <a href="../lab-2/guide/part-1.html">
            
                    
                    动态内存分配
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.3.3" data-path="../lab-2/guide/part-2.html">
            
                <a href="../lab-2/guide/part-2.html">
            
                    
                    物理内存探测
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.3.4" data-path="../lab-2/guide/part-3.html">
            
                <a href="../lab-2/guide/part-3.html">
            
                    
                    物理内存管理
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.3.5" data-path="../lab-2/guide/summary.html">
            
                <a href="../lab-2/guide/summary.html">
            
                    
                    小结
            
                </a>
            

            
        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter " data-level="3.4" >
            
                <span>
            
                    
                    实验指导三
            
                </span>
            

            
            <ul class="articles">
                
    
        <li class="chapter " data-level="3.4.1" data-path="../lab-3/guide/intro.html">
            
                <a href="../lab-3/guide/intro.html">
            
                    
                    摘要
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.4.2" data-path="../lab-3/guide/part-1.html">
            
                <a href="../lab-3/guide/part-1.html">
            
                    
                    从虚拟地址到物理地址
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.4.3" data-path="../lab-3/guide/part-2.html">
            
                <a href="../lab-3/guide/part-2.html">
            
                    
                    修改内核
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.4.4" data-path="../lab-3/guide/part-3.html">
            
                <a href="../lab-3/guide/part-3.html">
            
                    
                    实现页表
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.4.5" data-path="../lab-3/guide/part-4.html">
            
                <a href="../lab-3/guide/part-4.html">
            
                    
                    实现内核重映射
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.4.6" data-path="../lab-3/guide/part-5.html">
            
                <a href="../lab-3/guide/part-5.html">
            
                    
                    页面置换*
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.4.7" data-path="../lab-3/guide/summary.html">
            
                <a href="../lab-3/guide/summary.html">
            
                    
                    小结
            
                </a>
            

            
        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter " data-level="3.5" >
            
                <span>
            
                    
                    实验指导四
            
                </span>
            

            
            <ul class="articles">
                
    
        <li class="chapter " data-level="3.5.1" data-path="../lab-4/guide/intro.html">
            
                <a href="../lab-4/guide/intro.html">
            
                    
                    摘要
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.5.2" data-path="../lab-4/guide/part-1.html">
            
                <a href="../lab-4/guide/part-1.html">
            
                    
                    线程和进程
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.5.3" data-path="../lab-4/guide/part-2.html">
            
                <a href="../lab-4/guide/part-2.html">
            
                    
                    线程的创建
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.5.4" data-path="../lab-4/guide/part-3.html">
            
                <a href="../lab-4/guide/part-3.html">
            
                    
                    线程的切换
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.5.5" data-path="../lab-4/guide/part-4.html">
            
                <a href="../lab-4/guide/part-4.html">
            
                    
                    线程的结束
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.5.6" data-path="../lab-4/guide/part-5.html">
            
                <a href="../lab-4/guide/part-5.html">
            
                    
                    内核栈
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.5.7" data-path="../lab-4/guide/part-6.html">
            
                <a href="../lab-4/guide/part-6.html">
            
                    
                    线程调度
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.5.8" data-path="../lab-4/guide/summary.html">
            
                <a href="../lab-4/guide/summary.html">
            
                    
                    小结
            
                </a>
            

            
        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter " data-level="3.6" >
            
                <span>
            
                    
                    实验指导五
            
                </span>
            

            
            <ul class="articles">
                
    
        <li class="chapter " data-level="3.6.1" data-path="../lab-5/guide/intro.html">
            
                <a href="../lab-5/guide/intro.html">
            
                    
                    摘要
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.6.2" data-path="../lab-5/guide/part-1.html">
            
                <a href="../lab-5/guide/part-1.html">
            
                    
                    设备树
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.6.3" data-path="../lab-5/guide/part-2.html">
            
                <a href="../lab-5/guide/part-2.html">
            
                    
                    virtio
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.6.4" data-path="../lab-5/guide/part-3.html">
            
                <a href="../lab-5/guide/part-3.html">
            
                    
                    驱动和块设备驱动
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.6.5" data-path="../lab-5/guide/part-4.html">
            
                <a href="../lab-5/guide/part-4.html">
            
                    
                    文件系统
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.6.6" data-path="../lab-5/guide/summary.html">
            
                <a href="../lab-5/guide/summary.html">
            
                    
                    小结
            
                </a>
            

            
        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter " data-level="3.7" >
            
                <span>
            
                    
                    实验指导六
            
                </span>
            

            
            <ul class="articles">
                
    
        <li class="chapter " data-level="3.7.1" data-path="../lab-6/guide/intro.html">
            
                <a href="../lab-6/guide/intro.html">
            
                    
                    摘要
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.7.2" data-path="../lab-6/guide/part-1.html">
            
                <a href="../lab-6/guide/part-1.html">
            
                    
                    构建用户程序框架
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.7.3" data-path="../lab-6/guide/part-2.html">
            
                <a href="../lab-6/guide/part-2.html">
            
                    
                    打包为磁盘镜像
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.7.4" data-path="../lab-6/guide/part-3.html">
            
                <a href="../lab-6/guide/part-3.html">
            
                    
                    解析 ELF 文件并创建线程
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.7.5" data-path="../lab-6/guide/part-4.html">
            
                <a href="../lab-6/guide/part-4.html">
            
                    
                    实现系统调用
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.7.6" data-path="../lab-6/guide/part-5.html">
            
                <a href="../lab-6/guide/part-5.html">
            
                    
                    处理文件描述符
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.7.7" data-path="../lab-6/guide/part-6.html">
            
                <a href="../lab-6/guide/part-6.html">
            
                    
                    条件变量
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="3.7.8" data-path="../lab-6/guide/summary.html">
            
                <a href="../lab-6/guide/summary.html">
            
                    
                    小结
            
                </a>
            

            
        </li>
    

            </ul>
            
        </li>
    

    
        
        <li class="header">实验题</li>
        
        
    
        <li class="chapter " data-level="4.1" data-path="../lab-1/practice.html">
            
                <a href="../lab-1/practice.html">
            
                    
                    实验一：中断
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="4.2" data-path="../lab-2/practice.html">
            
                <a href="../lab-2/practice.html">
            
                    
                    实验二：内存分配
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="4.3" data-path="../lab-3/practice.html">
            
                <a href="../lab-3/practice.html">
            
                    
                    实验三：虚实地址转换
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="4.4" data-path="../lab-4/practice-1.html">
            
                <a href="../lab-4/practice-1.html">
            
                    
                    实验四（上）：线程
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="4.5" data-path="../lab-4/practice-2.html">
            
                <a href="../lab-4/practice-2.html">
            
                    
                    实验四（下）：线程调度
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="4.6" data-path="../lab-6/practice.html">
            
                <a href="../lab-6/practice.html">
            
                    
                    实验六：系统调用
            
                </a>
            

            
        </li>
    

    
        
        <li class="header">开发笔记</li>
        
        
    
        <li class="chapter " data-level="5.1" data-path="partition.html">
            
                <a href="partition.html">
            
                    
                    文档代码划分
            
                </a>
            

            
        </li>
    
        <li class="chapter active" data-level="5.2" data-path="doc.html">
            
                <a href="doc.html">
            
                    
                    文档格式规范
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="5.3" data-path="code.html">
            
                <a href="code.html">
            
                    
                    代码格式规范
            
                </a>
            

            
        </li>
    

    

    <li class="divider"></li>

    <li>
        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
            Published with GitBook
        </a>
    </li>
</ul>


                </nav>
            
        
    </div>

    <div class="book-body">
        
            <div class="body-inner">
                
                    

<div class="book-header" role="navigation">
    

    <!-- Title -->
    <h1>
        <i class="fa fa-circle-o-notch fa-spin"></i>
        <a href="../.." >文档格式规范</a>
    </h1>
</div>




                    <div class="page-wrapper" tabindex="-1" role="main">
                        <div class="page-inner">
                            
<div id="book-search-results">
    <div class="search-noresults">
    
<div id="book-search-results">
    <div class="search-noresults">
    
                                <section class="normal markdown-section">
                                
                                <h2 id="&#x6587;&#x6863;&#x89C4;&#x8303;">&#x6587;&#x6863;&#x89C4;&#x8303;</h2>
<h3 id="&#x4E00;&#x4E9B;&#x6807;&#x51C6;&#x7684;&#x67B6;&#x6784;&#x3001;&#x8F6F;&#x4EF6;&#x540D;&#x8BCD;&#x5199;&#x6CD5;">&#x4E00;&#x4E9B;&#x6807;&#x51C6;&#x7684;&#x67B6;&#x6784;&#x3001;&#x8F6F;&#x4EF6;&#x540D;&#x8BCD;&#x5199;&#x6CD5;</h3>
<ul>
<li>&#x8BED;&#x8A00;&#x76F8;&#x5173;<ul>
<li>Rust</li>
<li>C</li>
<li>C++</li>
<li>Markdown</li>
</ul>
</li>
<li>&#x6559;&#x7A0B;<ul>
<li>rCore-Tutorial</li>
</ul>
</li>
<li>&#x64CD;&#x4F5C;&#x7CFB;&#x7EDF;&#x76F8;&#x5173;<ul>
<li>uCore</li>
<li>rCore</li>
<li>Linux</li>
<li>macOS</li>
<li>Windows</li>
<li>Ubuntu</li>
</ul>
</li>
<li>&#x64CD;&#x4F5C;&#x7CFB;&#x7EDF;&#x6280;&#x672F;&#x76F8;&#x5173;<ul>
<li>&#x7269;&#x7406;&#x9875;&#xFF08;&#x800C;&#x4E0D;&#x662F;&#x7269;&#x7406;&#x9875;&#x5E27;&#xFF09;</li>
<li>&#x865A;&#x62DF;&#x9875;&#xFF08;&#x800C;&#x4E0D;&#x662F;&#x7269;&#x7406;&#x9875;&#x5E27;&#xFF09;</li>
</ul>
</li>
<li>&#x67B6;&#x6784;&#x76F8;&#x5173;<ul>
<li>x86_64</li>
<li>RISC-V 64</li>
</ul>
</li>
<li>&#x5176;&#x4ED6;&#x4E00;&#x4E9B;&#x540D;&#x8BCD;<ul>
<li>ABI</li>
<li>GitHub</li>
<li>virtio</li>
</ul>
</li>
<li>Rust &#x76F8;&#x5173;<ul>
<li>rustup</li>
<li>cargo</li>
<li>rustc</li>
</ul>
</li>
<li>&#x5176;&#x4ED6;&#x8F6F;&#x4EF6;<ul>
<li>QEMU</li>
<li>Homebrew</li>
</ul>
</li>
</ul>
<h3 id="&#x5185;&#x5BB9;&#x63A7;&#x5236;">&#x5185;&#x5BB9;&#x63A7;&#x5236;</h3>
<ul>
<li>&#x6211;&#x4EEC;&#x7684;&#x76EE;&#x6807;&#x9488;&#x5BF9;&#x4E8E;&#x300C;&#x505A;&#x5B9E;&#x9A8C;&#x7684;&#x540C;&#x5B66;&#x300D;&#xFF0C;&#x5BF9;&#x60F3;&#x5B8C;&#x6574;&#x5B9E;&#x73B0;&#x4E00;&#x4E2A; rCore &#x7684;&#x540C;&#x5B66;&#x6765;&#x8BF4;&#x53EF;&#x80FD;&#x4E0D;&#x592A;&#x53CB;&#x597D;&#xFF1B;</li>
<li>&#x4F46;&#x662F;&#x6211;&#x4EEC;&#x4E5F;&#x76F8;&#x4FE1;&#xFF0C;&#x8FD9;&#x90E8;&#x5206;&#x60F3;&#x5B8C;&#x6574;&#x5B9E;&#x73B0;&#x7684;&#x540C;&#x5B66;&#x4E5F;&#x4E0D;&#x4F1A;&#x56E0;&#x4E3A;&#x6211;&#x4EEC;&#x5728;&#x6587;&#x6863;&#x4E2D;&#x5C11;&#x4E9B;&#x4E86;&#x4E00;&#x90E8;&#x5206;&#x975E;&#x5E38;&#x7EC6;&#x8282;&#x7684;&#x8BF8;&#x5982;&#x6A21;&#x5757;&#x8C03;&#x7528;&#x7684;&#x5185;&#x5BB9;&#x5C31;&#x653E;&#x5F03;&#xFF0C;&#x800C;&#x4E14;&#x4ECE;&#x5934;&#x590D;&#x5236;&#x5230;&#x5C3E;&#x4E5F;&#x4E0D;&#x662F;&#x4E00;&#x4E2A;&#x597D;&#x7684;&#x505A;&#x6CD5;&#xFF0C;&#x8FD9;&#x4E0D;&#x4F1A;&#x8BA9;&#x4F60;&#x5BF9;&#x64CD;&#x4F5C;&#x7CFB;&#x7EDF;&#x6709;&#x66F4;&#x6DF1;&#x523B;&#x7684;&#x7406;&#x89E3;&#xFF1B;</li>
<li>&#x6240;&#x4EE5;&#xFF0C;&#x5728;&#x6587;&#x6863;&#x5F00;&#x53D1;&#x8FC7;&#x7A0B;&#x4E2D;&#xFF0C;&#x6211;&#x4EEC;&#x9700;&#x8981;&#x5BF9;&#x6E05;&#x6670;&#x548C;&#x5168;&#x9762;&#x505A;&#x5F88;&#x591A;&#x7684;&#x6743;&#x8861;&#x548C;&#x8003;&#x8651;&#xFF0C;&#x9700;&#x8981;&#x7701;&#x7565;&#x6389;&#x5927;&#x91CF;&#x8BED;&#x6CD5;&#x5C42;&#x9762;&#x800C; OS &#x65E0;&#x5173;&#x7684;&#x4EE3;&#x7801;&#x6765;&#x5E26;&#x6765;&#x66F4;&#x591A;&#x7684;&#x53EF;&#x8BFB;&#x6027;&#x548C;&#x7CBE;&#x7B80;&#x6027;&#xFF1B;</li>
<li>&#x6240;&#x4EE5;&#xFF0C;&#x5728;&#x6587;&#x6863;&#x4E2D;&#x5F15;&#x7528;&#x7684;&#x4EE3;&#x7801;&#xFF0C;&#x53EA;&#x9700;&#x8981;&#x5199;&#x4E3B;&#x4F53;&#x7684;&#x51FD;&#x6570;&#xFF0C;&#x4E0D;&#x9700;&#x8981;&#x628A;&#x4E00;&#x7CFB;&#x5217;&#x8C03;&#x7528;&#x3001;&#x5934;&#x90E8;&#x6CE8;&#x91CA;&#x5168;&#x90E8;&#x52A0;&#x5165;&#x8FDB;&#x53BB;&#x3002;&#x5728;&#x6700;&#x540E;&#xFF0C;&#x53EF;&#x80FD;&#x4F1A;&#x518D;&#x5229;&#x7528;&#x4EE3;&#x7801;&#x6298;&#x53E0;&#x7684;&#x65B9;&#x5F0F;&#x5BF9;&#x8FD9;&#x4E2A;&#x95EE;&#x9898;&#x8FDB;&#x4E00;&#x6B65;&#x6743;&#x8861;&#x3002;</li>
</ul>
<h3 id="&#x4E66;&#x5199;&#x683C;&#x5F0F;">&#x4E66;&#x5199;&#x683C;&#x5F0F;</h3>
<ul>
<li>&#x5728;&#x6570;&#x5B57;&#x3001;&#x82F1;&#x6587;&#x3001;&#x72EC;&#x7ACB;&#x7684;&#x6807;&#x70B9;&#x6216;&#x8BB0;&#x53F7;&#x4E24;&#x4FA7;&#x7684;&#x4E2D;&#x6587;&#x4E4B;&#x95F4;&#x8981;&#x52A0;&#x7A7A;&#x683C;&#xFF0C;&#x5982;&#xFF1A;<ul>
<li>&#x5B89;&#x88C5; QEMU</li>
<li>&#x5206;&#x4E3A; 2 &#x4E2A;&#x90E8;&#x5206;</li>
</ul>
</li>
<li>&#x547D;&#x4EE4;&#x3001;&#x5B8F;&#x540D;&#x3001;&#x5BC4;&#x5B58;&#x5668;&#x3001;&#x7C7B;&#x578B;&#x540D;&#x3001;&#x51FD;&#x6570;&#x540D;&#x3001;&#x53D8;&#x91CF;&#x540D;&#x3001;&#x884C;&#x95F4;&#x8F93;&#x51FA;&#x3001;&#x7F16;&#x8BD1;&#x9009;&#x9879;&#x3001;&#x8DEF;&#x5F84;&#x548C;&#x6587;&#x4EF6;&#x540D;&#x9700;&#x8981;&#x4F7F;&#x7528; `` &#x8BB0;&#x53F7;<ul>
<li>&#x5BC4;&#x5B58;&#x5668; <code>a0</code> &#x8FD9;&#x6837;&#x7684;&#x4E5F;&#x9700;&#x8981;&#x4F7F;&#x7528; `` &#x8BB0;&#x53F7;&#xFF0C;&#x800C;&#x4E0D;&#x662F; <span class="katex"><span class="katex-mathml"><math><semantics><mrow><msub><mi>a</mi><mn>0</mn></msub></mrow><annotation encoding="application/x-tex">a_0</annotation></semantics></math></span><span class="katex-html" aria-hidden="true"><span class="strut" style="height:0.43056em;"></span><span class="strut bottom" style="height:0.58056em;vertical-align:-0.15em;"></span><span class="base textstyle uncramped"><span class="mord"><span class="mord mathit">a</span><span class="msupsub"><span class="vlist"><span style="top:0.15em;margin-right:0.05em;margin-left:0em;"><span class="fontsize-ensurer reset-size5 size5"><span style="font-size:0em;">&#x200B;</span></span><span class="reset-textstyle scriptstyle cramped mtight"><span class="mord mathrm mtight">0</span></span></span><span class="baseline-fix"><span class="fontsize-ensurer reset-size5 size5"><span style="font-size:0em;">&#x200B;</span></span>&#x200B;</span></span></span></span></span></span></span>&#xFF0C;&#x8FD9;&#x662F;&#x4E3A;&#x4E86;&#x548C; <code>sepc</code> &#x7EDF;&#x4E00;</li>
</ul>
</li>
<li>&#x884C;&#x5185;&#x547D;&#x4EE4;&#x6216;&#x8FD0;&#x884C;&#x8F93;&#x51FA;&#x5F15;&#x7528;&#x4F7F;&#x7528; `` &#x8BB0;&#x53F7;&#xFF0C;&#x5E76;&#x5728;&#x4E24;&#x4FA7;&#x52A0;&#x5165;&#x7A7A;&#x683C;&#xFF0C;&#x5982;&#xFF1A;<ul>
<li><code>cargo run</code></li>
<li>&#x51FA;&#x73B0; <code>ERROR: pkg-config binary &apos;pkg-config&apos; not found</code> &#x65F6;</li>
</ul>
</li>
<li>&#x884C;&#x95F4;&#x547D;&#x4EE4;&#x4F7F;&#x7528; ``` &#x8BB0;&#x53F7;&#x5E76;&#x52A0;&#x5165;&#x8BED;&#x8A00;&#x8BB0;&#x53F7;&#xFF1A;<ul>
<li>&#x547D;&#x4EE4;&#x4F7F;&#x7528; bash &#x8BB0;&#x53F7;</li>
<li>Rust &#x8BED;&#x8A00;&#x4F7F;&#x7528; rust &#x8BB0;&#x53F7;</li>
<li>cargo &#x7684;&#x914D;&#x7F6E;&#x4F7F;&#x7528; toml &#x8BB0;&#x53F7;</li>
<li>&#x5982;&#x4F55;&#x547D;&#x4EE4;&#x53EA;&#x662F;&#x547D;&#x4EE4;&#xFF0C;&#x5219;&#x4E0D;&#x9700;&#x8981; $ &#x8BB0;&#x53F7;&#xFF08;&#x65B9;&#x4FBF;&#x540C;&#x5B66;&#x590D;&#x5236;&#xFF09;&#xFF0C;&#x5982;&#xFF1A;<pre><code class="lang-bash"><span class="hljs-built_in">echo</span> <span class="hljs-string">&quot;Hello, world.&quot;</span>
</code></pre>
</li>
<li>&#x5982;&#x679C;&#x5728;&#x5C55;&#x793A;&#x4E00;&#x4E2A;&#x547D;&#x4EE4;&#x5E26;&#x6765;&#x7684;&#x8F93;&#x51FA;&#x6548;&#x679C;&#xFF0C;&#x9700;&#x8981;&#x52A0;&#x5165; $ &#x8BB0;&#x53F7;&#x8868;&#x793A;&#x4E00;&#x4E2A;&#x547D;&#x4EE4;&#x7684;&#x5F00;&#x59CB;&#xFF0C;&#x5982;&#xFF1A;<pre><code class="lang-bash">$ <span class="hljs-built_in">echo</span> <span class="hljs-string">&quot;Hello, world.&quot;</span>
Hello, world.
</code></pre>
</li>
</ul>
</li>
<li>&#x7C97;&#x4F53;&#x4F7F;&#x7528; ** <strong>&#x7C97;&#x4F53;</strong> ** &#x8BB0;&#x53F7;<ul>
<li>&#x4E00;&#x4E9B;&#x91CD;&#x8981;&#x7684;&#x6982;&#x5FF5;&#x6700;&#x597D;&#x8FDB;&#x884C;&#x52A0;&#x7C97;</li>
</ul>
</li>
<li>&#x659C;&#x4F53;&#x4F7F;&#x7528; * <em>&#x659C;&#x4F53;</em> * &#x8BB0;&#x53F7;&#xFF0C;&#x800C;&#x4E0D;&#x8981;&#x6DF7;&#x5408;&#x4F7F;&#x7528; _ <em>Italic</em> _ &#x8BB0;&#x53F7;</li>
<li>&#x5728;&#x6B63;&#x5F0F;&#x7684;&#x6BB5;&#x843D;&#x4E2D;&#x8981;&#x52A0;&#x5165;&#x6807;&#x70B9;&#x7B26;&#x53F7;&#xFF0C;&#x5728; - &#x8BB0;&#x53F7;&#x5F00;&#x59CB;&#x7684;&#x5217;&#x8868;&#x4E2D;&#x7684;&#x5355;&#x72EC;&#x540D;&#x8BCD;&#x8868;&#x9879;&#x4E0D;&#x52A0;&#x5165;&#x6807;&#x70B9;&#x7B26;&#x53F7;&#xFF08;&#x4F46;&#x662F;&#x5982;&#x679C;&#x662F;&#x6BB5;&#x843D;&#x9700;&#x8981;&#x52A0;&#xFF09;&#xFF0C;&#x5982;&#xFF1A;<ul>
<li>&#x64CD;&#x4F5C;&#x7CFB;&#x7EDF;&#x6709;&#xFF08;&#x540D;&#x8BCD;&#x7F57;&#x5217;&#xFF09;&#xFF1A;<ul>
<li>macOS</li>
<li>Windows</li>
</ul>
</li>
<li>&#x6211;&#x4EEC;&#x9700;&#x8981;&#xFF08;&#x8FDE;&#x8D2F;&#x6BB5;&#x843D;&#xFF09;&#xFF1A;<ul>
<li>&#x5148;&#x6253;&#x5F00; QEMU&#xFF1B;</li>
<li>&#x518D;&#x5173;&#x95ED; QEMU&#x3002;</li>
</ul>
</li>
</ul>
</li>
<li>&#x5728; / &#x8BB0;&#x53F7;&#x4E24;&#x4FA7;&#x6DFB;&#x52A0;&#x7A7A;&#x683C;&#xFF0C;&#x5982;&#xFF1A;<ul>
<li>Linux / Windows WSL</li>
</ul>
</li>
<li>&#x4E2D;&#x6587;&#x540D;&#x8BCD;&#x7684;&#x82F1;&#x6587;&#x89E3;&#x91CA;&#x591A;&#x7528;&#x5927;&#x5199;&#xFF0C;&#x5982;&#xFF1A;<ul>
<li>&#x88F8;&#x673A;&#xFF08;Bare Metal&#xFF09;</li>
<li><code>sepc</code> &#xFF08;Supervisor Exception Program Counter&#xFF09;</li>
</ul>
</li>
<li>&#x53EA;&#x8981;&#x662F;&#x4E3B;&#x4F53;&#x662F;&#x4E2D;&#x6587;&#x7684;&#x6BB5;&#x843D;&#xFF0C;&#x62EC;&#x53F7;&#x7EDF;&#x4E00;&#x4F7F;&#x7528;&#x4E2D;&#x6587;&#x62EC;&#x53F7;&#xFF08;&#xFF09;&#xFF0C;&#x5982;&#x679C;&#x4E3B;&#x4F53;&#x662F;&#x82F1;&#x6587;&#x5219;&#x4F7F;&#x7528;&#x82F1;&#x6587;&#x62EC;&#x53F7; ()<ul>
<li>&#x503C;&#x5F97;&#x6CE8;&#x610F;&#x7684;&#x662F;&#x4E2D;&#x6587;&#x62EC;&#x53F7;&#x4E24;&#x4FA7;&#x672C;&#x6765;&#x5C31;&#x4F1A;&#x53C8;&#x7559;&#x767D;&#xFF0C;&#x8FD9;&#x91CC;&#x4E0D;&#x4F1A;&#x5728;&#x62EC;&#x53F7;&#x4E24;&#x4FA7;&#x52A0;&#x5165;&#x7A7A;&#x683C;</li>
<li>&#x82F1;&#x6587;&#x7A7A;&#x683C;&#x4E24;&#x4FA7;&#x6700;&#x597D;&#x52A0;&#x4E0A;&#x7A7A;&#x683C;</li>
</ul>
</li>
<li><p>&#x5728;&#x6587;&#x6863;&#x4E2D;&#x5F15;&#x7528;&#x6210;&#x6BB5;&#x7684;&#x4EE3;&#x7801;&#x65F6;&#xFF0C;&#x9700;&#x8981;&#x586B;&#x5199;&#x4E0A;&#x6587;&#x4EF6;&#x7684;&#x8DEF;&#x5F84;&#xFF0C;&#x5982;&#xFF1A;</p>
<p></p><p class="code-label">os/src/sbi.rs</p><p></p>
<pre><code class="lang-rust"><span class="hljs-comment">/// &#x5411;&#x63A7;&#x5236;&#x53F0;&#x8F93;&#x51FA;&#x4E00;&#x4E2A;&#x5B57;&#x7B26;</span>
<span class="hljs-comment">///</span>
<span class="hljs-comment">/// &#x9700;&#x8981;&#x6CE8;&#x610F;&#x6211;&#x4EEC;&#x4E0D;&#x80FD;&#x76F4;&#x63A5;&#x4F7F;&#x7528; Rust &#x4E2D;&#x7684; char &#x7C7B;&#x578B;</span>
<span class="hljs-keyword">pub</span> <span class="hljs-function"><span class="hljs-keyword">fn</span> <span class="hljs-title">console_putchar</span></span>(c: usize) {
    sbi_call(SBI_CONSOLE_PUTCHAR, c, <span class="hljs-number">0</span>, <span class="hljs-number">0</span>);
}
</code></pre>
</li>
<li>&#x5728;&#x4F7F;&#x7528;&#x4F2A;&#x4EE3;&#x7801;&#x65F6;&#xFF0C;&#x4E0D;&#x4F7F;&#x7528; <code>$</code> <code>%</code> &#x7B49;&#x7B26;&#x53F7;&#x63CF;&#x8FF0;&#x5BC4;&#x5B58;&#x5668;&#xFF0C;&#x4F7F;&#x7528; <code>:=</code> &#x8868;&#x793A;&#x8D4B;&#x503C;&#xFF0C;&#x4F8B;&#x5982; <code>pc := sepc</code></li>
<li>&#x4EE3;&#x7801;&#x8FC7;&#x957F;&#x6216;&#x4F1A;&#x8BA9;&#x6587;&#x6863;&#x663E;&#x5F97;&#x5F88;&#x957F;&#x65F6;&#xFF0C;&#x9700;&#x8981;&#x8FDB;&#x884C;&#x6298;&#x53E0;</li>
<li>&#x5F3A;&#x8C03;&#x8BF7;&#x4F7F;&#x7528;&#x300C;&#x5F3A;&#x8C03;&#x300D;&#xFF0C;&#x800C;&#x4E0D;&#x662F;&#x300E;&#x5F3A;&#x8C03;&#x300F;</li>
</ul>
<h3 id="&#x5C0F;&#x8282;&#x683C;&#x5F0F;">&#x5C0F;&#x8282;&#x683C;&#x5F0F;</h3>
<ul>
<li>&#x7AE0;&#x8282;&#x7684;&#x6807;&#x9898;&#x4E3A;&#x4F7F;&#x7528; <code>#</code> &#x4E00;&#x7EA7;&#x6807;&#x9898;&#xFF0C;&#x540E;&#x9762;&#x7684;&#x5B50;&#x6807;&#x9898;&#x4F9D;&#x6B21;&#x52A0;&#x7EA7;&#x522B;</li>
<li>&#x5C0F;&#x8282;&#x7684;&#x6807;&#x9898;&#x7EDF;&#x4E00;&#x4F7F;&#x7528; <code>##</code> &#x4E8C;&#x7EA7;&#x6807;&#x9898;&#xFF0C;&#x540E;&#x9762;&#x7684;&#x5B50;&#x6807;&#x9898;&#x4F9D;&#x6B21;&#x52A0;&#x7EA7;&#x522B;
<div id="page-footer" class="localized-footer"><hr><p><link rel="stylesheet" href="https://unpkg.com/gitalk/dist/gitalk.css"></p>
<script src="https://unpkg.com/gitalk/dist/gitalk.min.js"></script>
<div id="gitalk-container"></div>
<script>
    var gitalk = new Gitalk({
        clientID: "5084c46751a4b2f7cd4d",
        clientSecret: "3904f62d33aef24f19480fedc836a48b31d532e9",
        repo: "rCore-Tutorial-deploy",
        owner: "rcore-os",
        admin: [
            "chyyuu",
            "wangrunji0408",
            "xy-plus",
            "wyfcyx",
            "LyricZhao",
            "Tuyixiang"
        ],
        id: location.pathname.replace('/rCore-Tutorial-deploy', '').replace('.html', ''),
        distractionFreeMode: false
    });
    gitalk.render("gitalk-container");
</script></div></li>
</ul>

                                
                                </section>
                            
    </div>
    <div class="search-results">
        <div class="has-results">
            
            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
            <ul class="search-results-list"></ul>
            
        </div>
        <div class="no-results">
            
            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
            
        </div>
    </div>
</div>

    </div>
    <div class="search-results">
        <div class="has-results">
            
            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
            <ul class="search-results-list"></ul>
            
        </div>
        <div class="no-results">
            
            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
            
        </div>
    </div>
</div>

                        </div>
                    </div>
                
            </div>

            
                
                <a href="partition.html" class="navigation navigation-prev " aria-label="Previous page: 文档代码划分">
                    <i class="fa fa-angle-left"></i>
                </a>
                
                
                <a href="code.html" class="navigation navigation-next " aria-label="Next page: 代码格式规范">
                    <i class="fa fa-angle-right"></i>
                </a>
                
            
        
    </div>

    <script>
        var gitbook = gitbook || [];
        gitbook.push(function() {
            gitbook.page.hasChanged({"page":{"title":"文档格式规范","level":"5.2","depth":1,"next":{"title":"代码格式规范","level":"5.3","depth":1,"path":"docs/format/code.md","ref":"docs/format/code.md","articles":[]},"previous":{"title":"文档代码划分","level":"5.1","depth":1,"path":"docs/format/partition.md","ref":"docs/format/partition.md","articles":[]},"dir":"ltr"},"config":{"gitbook":"*","theme":"default","variables":{},"plugins":["hide-element","chapter-fold","katex","alerts","emphasize","mermaid-gb3","codeblock-label","code","search-pro","click-reveal","expandable-chapters-interactive","localized-footer"],"pluginsConfig":{"chapter-fold":{},"emphasize":{},"codeblock-label":{},"search-pro":{},"search":{},"localized-footer":{"filename":"gitalk.html","hline":"true"},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"code":{"copyButtons":true},"hide-element":{},"katex":{},"fontsettings":{"theme":"white","family":"sans","size":1},"click-reveal":{},"highlight":{},"mermaid-gb3":{},"expandable-chapters-interactive":{},"alerts":{},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"}},"file":{"path":"docs/format/doc.md","mtime":"2020-10-01T11:39:40.475Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2020-10-01T11:40:38.595Z"},"basePath":"../..","book":{"language":""}});
        });
    </script>
</div>

        
    
    <script src="../../gitbook/gitbook.js"></script>
    <script src="../../gitbook/theme.js"></script>
    
        
        <script src="../../gitbook/gitbook-plugin-hide-element/plugin.js"></script>
        
    
        
        <script src="../../gitbook/gitbook-plugin-chapter-fold/chapter-fold.js"></script>
        
    
        
        <script src="../../gitbook/gitbook-plugin-alerts/plugin.js"></script>
        
    
        
        <script src="../../gitbook/gitbook-plugin-mermaid-gb3/book/plugin.js"></script>
        
    
        
        <script src="../../gitbook/gitbook-plugin-code/plugin.js"></script>
        
    
        
        <script src="../../gitbook/gitbook-plugin-search-pro/jquery.mark.min.js"></script>
        
    
        
        <script src="../../gitbook/gitbook-plugin-search-pro/search.js"></script>
        
    
        
        <script src="../../gitbook/gitbook-plugin-click-reveal/click_reveal.js"></script>
        
    
        
        <script src="../../gitbook/gitbook-plugin-expandable-chapters-interactive/expandable-chapters.js"></script>
        
    
        
        <script src="../../gitbook/gitbook-plugin-search/search-engine.js"></script>
        
    
        
        <script src="../../gitbook/gitbook-plugin-search/search.js"></script>
        
    
        
        <script src="../../gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
        
    
        
        <script src="../../gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
        
    
        
        <script src="../../gitbook/gitbook-plugin-sharing/buttons.js"></script>
        
    
        
        <script src="../../gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
        
    

    <script src="../../gitbook/gitbook-plugin-mermaid-gb3/mermaid/mermaid.min.js"></script>

    </body>
</html>

